package com.papercutting.platform.service;

import com.papercutting.platform.dto.response.UserStudyResponse;
import com.papercutting.platform.entity.UserStudy;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;

import java.util.List;
import java.util.Map;

/**
 * 用户学习记录服务接口
 */
public interface UserStudyService {
    
    /**
     * 保存学习记录
     */
    UserStudy save(UserStudy userStudy);
    
    /**
     * 根据ID查找学习记录
     */
    UserStudy findById(Long id);
    
    /**
     * 查找所有学习记录
     */
    List<UserStudy> findAll();
    
    /**
     * 分页查找学习记录
     */
    Page<UserStudy> findAll(Pageable pageable);
    
    /**
     * 根据ID删除学习记录
     */
    void deleteById(Long id);
    
    /**
     * 根据用户ID查找学习记录
     */
    List<UserStudy> findByUserId(Long userId);
    
    /**
     * 根据教程ID查找学习记录
     */
    List<UserStudy> findByTutorialId(Long tutorialId);
    
    /**
     * 根据用户ID和教程ID查找学习记录
     */
    UserStudy findByUserIdAndTutorialId(Long userId, Long tutorialId);
    
    /**
     * 根据完成状态查找学习记录
     */
    List<UserStudy> findByIsCompleted(Boolean isCompleted);
    
    /**
     * 根据用户ID和完成状态查找学习记录
     */
    List<UserStudy> findByUserIdAndIsCompleted(Long userId, Boolean isCompleted);
    
    /**
     * 分页查询用户学习记录列表
     */
    Page<UserStudy> findUserStudyList(Long userId, Pageable pageable);
    
    /**
     * 分页查询用户学习记录列表（包含教程信息）
     */
    Page<UserStudyResponse> findUserStudyListWithTutorial(Long userId, Pageable pageable);
    
    /**
     * 获取用户学习进度统计
     */
    Map<String, Object> getStudyProgress(Long userId);
}